home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / cdpro.zip / CDPRO11.DOC < prev    next >
Text File  |  1992-01-17  |  16KB  |  332 lines
  1.  
  2.                                    CD-ROM PRO
  3.                  Librarian/File Manager for CD-ROM Collections
  4.  
  5.                                   Version 1.1
  6.  
  7.                                    SHAREWARE
  8.                               All Rights Reserved
  9.                             (c) 1993 Vince Sorensen
  10.  
  11. ───────────────────────────────────────────────────────────────────────────────
  12. If you have been using Version 1.00, ensure that you download CDPRO11C.ARJ
  13. and use the CONVMULT.BAT file enclosed to convert your files.
  14. ───────────────────────────────────────────────────────────────────────────────
  15.  
  16. This program was written originally to keep track of what programs were on
  17. what CD-ROM, and to eliminate duplicate files on floppy. It allows the user to
  18. quickly find and view/run/copy any file on any CD-ROM, as well as reporting
  19. on duplication and/or unique files between CDs, whether in the user's
  20. collection or not. Text file format conversion is also supported, with
  21. the ability to fill in information found on the actual CD if it was not
  22. included in the text files originally.
  23.  
  24.  
  25. ───────────────────────────────────────────────────────────────────────────────
  26. Registration Fee: $15 or more will be rewarded with support and BBS membership,
  27.                   but any donation is appreciated! Upgrades are free (excludes
  28.                   shipping).
  29. Author Address:   Vince Sorensen                   BBS Info:
  30.                   6 Armstrong Bay                     Superboard 1:140/121
  31.                   Regina, Sk., Canada                 (306)789-8682
  32.                   S4N 4G7                             14400 v.32/v.42bis
  33. ───────────────────────────────────────────────────────────────────────────────
  34. This program has been beta tested under 4DOS, MS-DOS 5.0, Windows 3.1,
  35. Stacker 3.0, and SMARTDRV 5.0. If you encounter any problems, please
  36. contact the author on the aforementioned BBS, so that they can be
  37. fixed.                             Thanks!
  38. ───────────────────────────────────────────────────────────────────────────────
  39.  
  40.     Note: Pressing F1 gives context sensitive help wherever available.
  41.  
  42.  
  43. Quick Set-Up
  44. ────────────
  45.  
  46.     You should have a copy of CD_PRO.EXE and CD_PRO.HLP somewhere in your
  47.     path. The databases will be built in the current directory.
  48.  
  49.     To run this program:
  50.  
  51.     (1) You need text files containing the file listings for your CD-ROMs.
  52.     (2) Configure CD-ROM PRO File Manager to reflect your equipment
  53.         set-up, and use the "Format File Listings" option to enter the
  54.         format of the text files you will be importing (if not already
  55.         set up - some, such as PCBoard, already are). This means
  56.         checking the text files in (1) above, and noting the column
  57.         that the file name, date, size, and description information
  58.         begins in, and their length (in the case of the date, its format).
  59.         If a field is missing, set its column to zero. You can fill in
  60.         the date and size information later with the "Correct Date and
  61.         Size" function.
  62.     (3) If you will be importing a large number of text files, it is
  63.         recommended that you set up a file called "IMPORT.CNF" that
  64.         contains information on what CD and directory will be
  65.         imported, and which text file will contain the file names, etc.,
  66.         for that directory. The format of IMPORT.CNF is explained when
  67.         you select the "Import File Listings - IMPORT.CNF" feature on
  68.         page one of the Utilities. If you are still unsure of how to use
  69.         the IMPORT.CNF, or are only importing a small number of
  70.         directories, simply use the "Import File Listings - Interactive"
  71.         feature, on the same page.
  72.     (4) Use one of the "Import File Listings" features to import the
  73.         information you require. This program will automatically detect
  74.         if one-line or multiple-line descriptions are being entered
  75.         (PCBoard or LongLine Formats Only).
  76.         ┌────────────────────────────────────────────────────────────────┐
  77.         │  ** ADVANCED USERS**   If you are already sure of the format,  │
  78.         │  you can press CTRL-I from the main menu to skip right to the  │
  79.         │  IMPORT.CNF importing without wading though the menus and      │
  80.         │  having to confirm that you want to go ahead.                  │
  81.         └────────────────────────────────────────────────────────────────┘
  82.  
  83.  
  84.                             ─────────────────────
  85.  
  86.  
  87.  
  88. About File Listing Formats and Exporting File Listings:
  89. ───────────────────────────────────────────────────────
  90.  
  91. Using the Recreate File Listing option (also know as Create Listing of
  92. Files in a Directory) allows you to generate a formatted DOS file or
  93. printout of the list of files in a directory (not surprisingly!).
  94. All FILES.BBS file listings that are created using the "Re-Create/Print
  95. File Listings" option will use one-line descriptions, unless a "~", "|"
  96. is contained within the format name or one of the proprietary formats
  97. (described below - see "Format Conventions") is used.
  98.  
  99. Converting from a DOS file listing in one format to another will only
  100. convert the first line of each description, regardless of what multi-line
  101. options (as described below) are selected.
  102.  
  103. Format Conventions:
  104. ───────────────────
  105.  
  106. If the format title contains a "~" character, it indicates that the
  107. format is multi-line. The "~" should be followed by the number of lines
  108. of description allowed per file.
  109.  
  110.    I.E.:
  111.      MAXFMT~2 will output 2 line descriptions for each file.
  112.  
  113. If the format title contains a "|" character, it indicates that the
  114. description should be preceded by a "|". Note that the description
  115. is still placed at the position indicated in the format configuration.
  116. The "|" is placed two spaces before the description.
  117.  
  118. If both "|" and "~" are in the format title, the "|" is always placed
  119. before the 2nd and following lines, but only before the 1st line if
  120. the "|" precedes the "~".
  121.  
  122.     I.E.:
  123.        Taking the format "WILD" and simply changing the format name
  124.        has the following results:
  125.  
  126. If     WILD     outputs:      FILENAME.ZIP 91810 01-01-93  Description
  127.  
  128. then   WILD|    outputs:      FILENAME.ZIP 91810 01-01-93| Description
  129.  
  130. and    WILD|~2  outputs:      FILENAME.ZIP 91810 01-01-93| Description
  131.                                                          | Description Line 2
  132.  
  133. and    WILD~2|  outputs:      FILENAME.ZIP 91810 01-01-93  Description
  134.                                                          | Description Line 2
  135.  
  136. and    WILD~2   outputs:      FILENAME.ZIP 91810 01-01-93  Description
  137.                                                            Description Line 2
  138.  
  139. Also note that if there are not two spaces between the description and
  140. the previous field, and "|" is used, the previous field will be over-written.
  141.  
  142.  
  143.  
  144. Special Case (Proprietary Formats): If either the "PCBOARD" or
  145. "WILDCAT_2" file listing formats have been specified, special
  146. logic comes in to play to ensure the resulting FILES.BBS looks
  147. more like the proprietary formats used by these boards.
  148.  
  149. I.E.:
  150.  
  151. PCBOARD
  152. ARJ230.EXE    200363  02-07-92   This is what you'll use to extract files
  153.                                | that end in the ARJ extension. Its self-
  154.                                | extracting, so just type in ARJ230, and
  155.                                | then use the ARJ.EXE that comes out to
  156.                                | extract other files!
  157.  
  158. WILDCAT_2
  159. ARJ230.EXE    200,363   02/07/92 | This is what you'll use to extract files
  160. DwnLds: 3     DL Time   00:17:23 | that end in the ARJ extension.
  161.  
  162.  
  163.  
  164.                             ─────────────────────
  165.  
  166.  
  167. Program Parameters:
  168. ───────────────────
  169.  
  170. If you wish, you can specify the path to the databases when you
  171. start the program. For example,
  172.  
  173. CD_PRO C:\DATA
  174.  
  175. would look in the C:\DATA directory for all five of the databases.
  176. Please note that the import file information routine does
  177. NOT look at this path. C:\DATA\ and C: are also valid paths.
  178.  
  179. This way you can access your CD from any directory, and even use
  180. the current directory as a default to copy/unzip to.
  181.  
  182. You can also specify exact directory and file names for each of
  183. the individual databases using switches:
  184.  
  185. /F=FILE INFORMATION PATH AND FILE NAME
  186. /D=DIRECTORY INFORMATION PATH AND FILE NAME
  187. /C=CONFIGURATION INFORMATION PATH AND FILE NAME
  188. /L=FILE LISTING FORMATS PATH AND FILE NAME
  189. /T=TEMPORARY FILE
  190.  
  191. Filenames must either not have an extension, or have the extension
  192. .DAT
  193.  
  194. You cannot, however, mix the general and specific paths together.
  195. I.E.
  196. CD_PRO c:\data /f=c:\data\data\filedata.dat
  197. is not allowed.
  198.  
  199.  
  200.                             ─────────────────────
  201.  
  202.  
  203.  
  204. File Descriptions:
  205. ──────────────────
  206.  
  207. File descriptions are stored in a 1 line + 5 line format in order to save
  208. space... Since many CD-ROMs contain only 1 line descriptions, it would be
  209. wasteful to take up 6x48 bytes for every file's description when 48 would
  210. do. However, some CDs have PCBoard and 2 line style descriptions. This
  211. program determines if this is the case, and stores the 2nd and following
  212. lines in a special field that is only placed in records when necessary,
  213. saving the extra 240 bytes for each files with only a one-line description.
  214. On the tables of files shown in the program, only the first or first two
  215. lines are shown, and CTRL-D can be used to view the complete record.
  216. All searches check within the entire description, however.
  217.  
  218. Here's a sample screen of the extended description popped-up over the main
  219. file listing:
  220.  
  221. 42BOOT.ZIP       10210  4/08/92 Package th╔══════════════════════╗ot MS-DOS
  222.                                 MY CD-ROM ║ EXTENDED DESCRIPTION ║lternate Op. S
  223. 4CASE16.ZIP   ╔═══════════════════════════╝──────────────────────╢like case
  224.               ║ 42BOOT.ZIP       10210  4/08/92                  ║lternate Op. S
  225. 4DDBU512.ZIP  ║                                                  ║
  226.               ║ Package that allows you to dual boot MS-DOS      ║lternate Op. S
  227. 4DESC307.ZIP  ║ or DR-DOS easily using 4DOS' aliasing and INI    ║ber for
  228.               ║ (autoexecpath) capabilities to enhance /         ║lternate Op. S
  229. 4EDIT110.ZIP  ║ simplify booting up either operating system;     ║ creating &
  230.               ║ original config/autoexec are no longer used,     ║lternate Op. S
  231. 4LASER.ZIP    ║ so install programs which mangle... etc.         ║or sending
  232.               ║                                                  ║lternate Op. S
  233. 4LOGIC10.ZIP  ║ MY CD-ROM 7                                      ║ featuring
  234.               ║ 001A                                             ║lternate Op. S
  235. 4MICA25A.ZIP  ║ Alternate Op. Systems                            ║ll for
  236.               ║                                                  ║lternate Op. S
  237. 4PHONE.ZIP    ║         Press Any Key to Return to Table         ║along with
  238.               ╚══════════════════════════════════════════════════╝lternate Op. S
  239. ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
  240. ENTER to Change/View              ESC to Exit        CTRL-D Extended Description
  241. CTRL-S Search for Phrase          INSERT to Add               CTRL-X Execute Cmd
  242. CTRL-N Find Next Occurance        DELETE to Delete              CTRL-V View File
  243.  
  244.  
  245.                             ─────────────────────
  246.  
  247.  
  248. Text File Viewing:
  249. ──────────────────
  250.  
  251.   CD-ROM PRO File Manager contains an internal file viewer, with Search
  252.   and Line Jump Functions. However, if you have another text file
  253.   viewer you prefer, you can specify it in the Configuration menu.
  254.   To return to using the internal viewer, specify INTERNAL or leave
  255.   the TEXT VIEWER line blank. Please note that the internal file viewer
  256.   tries to load the file into memory - if you are viewing files over
  257.   140K in size, it is recommended that you use an external viewer, such
  258.   as LIST. Please note that only the file you are highlighting when you
  259.   press CTRL-V will be viewed (and the files it contains, if it is
  260.   archived) - tagged files are only used when executing DOS commands
  261.   with the CTRL-X key (see below).
  262.  
  263.  
  264.                             ─────────────────────
  265.  
  266. Executing Commands:
  267. ───────────────────
  268.  
  269. You have the option to execute a DOS command from within the program in a
  270. number of places by pressing CTRL-X. When you do, you'll be presented with
  271. the following screen:
  272.  
  273. ╔══════════════════════════════════════════════════════════════════════════════╗
  274. ║ EXECUTE COMMAND (up to 130 characters):                                      ║
  275. ║COPY C:\001A\42BOOT.ZIP                                                     ║
  276. ║                                                                              ║
  277. ║             ┌───────────────────────────────────────────────────┐            ║
  278. ║             │  Pressing CTRL-END clears to the end of the line  │            ║
  279. ║             │  Pressing ESC exits without executing command     │            ║
  280. ║             │  Pressing ENTER accepts and executes the command  │            ║
  281. ║             └───────────────────────────────────────────────────┘            ║
  282. ║                                                                              ║
  283. ║      ^    Indicates "Next command" (Divides multiple commands)               ║
  284. ║      ->   Indicates "Change to this directory before executing command"      ║
  285. ║      %TAG Indicates execute command for all tagged files                     ║
  286. ║      %FN  Indicates execute command on c:\001A\42BOOT.ZIP                    ║
  287. ║                                                                              ║
  288. ╚══════════════════════════════════════════════════════════════════════════════╝
  289.  
  290. ...and you can alter the command (between the symbols  and )
  291. however you wish, and then press ENTER to shell out to DOS and
  292. execute it. The default command is the one you specified in the
  293. Configuration screen, followed by the last path and file name
  294. referenced, unless you have tagged files, in which case the file
  295. name is replaced by %TAG.
  296.  
  297. In some areas, CTRL-C and CTRL-Z are also available. You are still
  298. presented with a default command, but CTRL-C will always begin with
  299. COPY instead of your default command, and CTRL-Z will begin with
  300. PKZIP instead of your default command. In addition, the default
  301. target directory you specified within Configuration will be appended
  302. to the end, following a "->". This way, you can copy, or even unzip
  303. the chosen file into a selected directory within a minimum of keystrokes.
  304.  
  305. Tagging notes:
  306.  
  307. Before calling the command screen, you may select (tag) files using the
  308. SPACE BAR. F10 will clear all tags. When entering commands, put
  309. %TAG where you would normally put the file path and file name. When
  310. the command is executed, the program will execute your command once
  311. for each tagged file, replacing the %TAG with the file path and name.
  312.  
  313. I.E.
  314. Below shows the results of pressing SPACE on INSTRUCT.ZIP and INSTRUC3.ZIP.
  315. The √ symbol shows that the file is tagged.
  316.  
  317. INSTRUCT.ZIP√    64234  01/01/93 Instructions for using this CD-ROM.
  318. INSTRUC2.ZIP    141434  01/01/93 Instructions for getting more CDs from us.
  319. INSTRUC3.ZIP√    25234  01/01/93 Advanced info for using this CD-ROM.
  320.  
  321. CTRL-X is pressed, and the following is entered:
  322. COPY %TAG \TEMP
  323.  
  324. The two tagged files are then copied into the \TEMP directory. Tags
  325. are cleared as the command is executed. If you have set "Prompt for
  326. CD change when executing commands on tagged files" (in CONFIGURATION)
  327. to "Y", you will be prompted before the first command is executed on
  328. each tagged file if the CD that the file is on is different than the
  329. last one accessed. At this prompt, you may choose to CANCEL by pressing
  330. the ESCAPE key. All remaining tagged files will REMAIN tagged, if you
  331. do this.
  332.